home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
TPUG - Toronto PET Users Group
/
TPUG Users Group CD
/
TPUG Users Group CD.iso
/
C64
/
T-TPUG Old Monthly Disks
/
(c)tb.d64
/
term64 doc.d
< prev
next >
Wrap
Text File
|
2007-02-04
|
32KB
|
1,322 lines
"
" 64╘┼╥═ - ┴ SMART TERMINAL PROGRAM FOR THE ├OMMODORE-64.
" ┴UTHOR OF PROGRAM AND MANUAL: ╨AUL ╚IGGINBOTTOM.
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...2
" ├ONTENTS:
" ╙ECTION ─ESCRIPTION ╨AGE
" --------------------------------------------------------
" 1. ╟ETTING STARTED ╪╪
" 2. ╘HE TOOLS ╪╪
" 3. ╘ERMINAL MODE ╪╪
" 4. ╘HE STATUS LINE ╪╪
" 5. ─ISK DIRECTORY ╪╪
" 6. ┼XAMINE/ALTER PROTOCOLS ╪╪
" 7. ╨RINT FILE/BUFFER TO SCREEN/PRINTER ╪╪
" 8. ┼XAMINE/ALTER FUNCTION KEYS ╪╪
" 9. ╠OAD OR SAVE PARAMETERS ╪╪
" 10. ╙END A FILE TO THE MODEM ╪╪
" 11. ╙AVE MEMORY BUFFER ╪╪
" 12. ┼XIT PROGRAM ╪╪
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...3
" ╟ETTING STARTED
" ╘O MAKE SURE NO PREVIOUS PROGRAMS, OR PROGRAMMING OF YOUR ├OMMODORE-64
" WILL AFFECT THE RUNNING OF THIS PROGRAM, TURN THE COMPUTER ╧╞╞, IF IT
" IS CURRENTLY ON.
"
" ╬OW TURN ╧╬ THE COMPUTER AND YOUR DISK UNIT, AND WITH THE PROGRAM
" DISKETTE IN THE DRIVE, TYPE:
"
" ╠╧┴─'╘┼╥═64',8,1
"
" AND PRESS ╥┼╘╒╥╬.
"
" ╘HE PROGRAM WILL AUTOMATICALLY RUN; THE SCREEN WILL GO BLANK, AND
" SHORTLY, THE MENU WILL APPEAR AS FOLLOWS:
"
" ---------------------------------------
" ╙MART ╘ERMINAL ╨ROGRAM
" ┬Y ╨AUL ╚IGGINBOTTOM
"
" (C)1983 ├OMMODORE ┬USINESS ═ACHINES ╠TD.
"
"
" 1. ┼NTER TERMINAL MODE
" 2. ─ISK DIRECTORY
" 3. ┼XAMINE/ALTER PROTOCOLS
" 4. ╨RINT FILE/BUFFER TO SCREEN/PRINTER
" 5. ┼XAMINE/ALTER FUNCTION KEYS
" 6. ╠OAD OR SAVE PARAMETERS
" 7. ╙END FILE TO MODEM
" 8. ╙AVE MEMORY BUFFER
" 9. ┼XIT PROGRAM
"
" ╨RESS '1' TO '9' TO SELECT FUNCTION
"
" ---------------------------------------
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...4
" ***********************************
" * *
" * ╬╬╬ ╬╬ ╧╧╧ ╘╘╘╘╘╘ ┼┼┼┼┼┼ *
" * ╬╬╬╬ ╬╬ ╧╧ ╧╧ ╘╘ ┼┼ *
" * ╬╬ ╬╬╬╬ ╧╧ ╧╧ ╘╘ ┼┼┼┼ *
" * ╬╬ ╬╬╬ ╧╧ ╧╧ ╘╘ ┼┼ *
" * ╬╬ ╬╬ ╧╧╧ ╘╘ ┼┼┼┼┼┼ *
" * *
" ***********************************
"
" ╞╥╧═ ┴╬┘ ╨╧╔╬╘ ╔╬ ╘╚┼ ╨╥╧╟╥┴═ (#1) ╘╧ ╥┼╘╒╥╬ ╘╧ ╘╚┼ ═┼╬╒, ╙╔═╨╠┘ ╨╥┼╙╙
" ╘╚┼ '╙╘╧╨' ╦┼┘.
"
" (#1 - ╔╬ ╘┼╥═╔╬┴╠ ═╧─┼, ╔╘'╙ ╙╚╔╞╘┼─ '╙╘╧╨' ╙╧ ╘╚┴╘ ╔╘ ├┴╬╬╧╘ ┬┼
" ╨╥┼╙╙┼─ ┴├├╔─┼╬╘┴╠╠┘).
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...5
" ╘HE TOOLS
" ╘HIS SECTION IS PROVIDED TO OUTLINE WHAT THIS PROGRAM CAN DO, AND AN
" OVERVIEW OF HOW IT CAN BE DONE.
"
" ╫HEN USING THIS PROGRAM, THERE ARE 3 FORMS OF INTERACTION YOU CAN HAVE
" WITH IT. ╘HEY ARE:
"
" 1. ═ENU FUNCTION SELECTION, AND SUPPLYING THE INFORMATION FOR A GIVEN
" OPTION.
"
" 2. ├OMMAND FUNCTION FROM TERMINAL MODE, TO CHANGE A 'MODE' OF
" OPERATION.
"
" 3. ╔NTERACTION WITH ANOTHER COMPUTER.
"
" ╘HE MENU SHOWS YOU THE OPTIONS AVAILABLE TO YOU, BUT PROVIDED BELOW IS
" A WIDER EXPLANATION OF EACH OPTION:
"
" 1. ┼NTER TERMINAL MODE - ╘HIS PUTS YOU IN A COMMUNICATIONS ENVIRONMENT,
" WHEREIN, EACH CHARACTER YOU TYPE WILL BE TRANSMITTED TO ANOTHER
" COMPUTER, AND EACH CHARACTER SENT TO YOU, BY THE OTHER COMPUTER YOU ARE
" COMMUNICATING WITH, WILL BE DISPLAYED ON YOUR SCREEN. ╔N TERMINAL
" MODE, THE SCREEN DISPLAYS A STATUS LINE (THE TOPE LINE OF THE SCREEN)
" AND THE REMAINING 24 LINES OF THE SCREEN ARE THE 'TERMINAL'S SCREEN.'
" ├ERTAIN KEY COMBINATIONS WILL ALTER THE VARIOUS STATUS 'INDICATORS' ON
" THE STATUS LINE.
"
" ╘HESE KEY FUNCTIONS ALLOW YOU TO MODIFY THE TERMINAL ENVIRONMENT (FOR
" EXAMPLE, ENABLING 'WORD-WRAP' WHICH COMMANDS THE PROGRAM TO
" AUTOMATICALLY AVOID WORDS BEING SPLIT AT THE END OF A LINE, BY
" 'PUSHING' THEM ONTO THE NEXT LINE.)
"
" 2. ─ISK DIRECTORY - ╘HIS WILL DISPLAY THE DIRECTORY OF THE DISKETTE IN
" THE DRIVE WHICH YOU WOULD USUALLY SEE BY DOING:
"
" ╠╧┴─'$',8
"
" ╠╔╙╘
"
" 3. ┼XAMINE/ALTER PROTOCOLS - ╘HIS OPTION ALLOWS YOU TO EXAMINE, AND/OR
" ALTER THE COMMUNICATIONS PROTOCOLS REQUIRED FOR THE PARTICULAR MODEM,
" AND/OR REMOTE COMPUTER. ┴N EXAMPLE OF A 'PROTOCOL' IS 'BAUD RATE',
" WHICH IS THE SPEED AT WHICH DATA IS TRANSFERED BETWEEN THE COMPUTERS'
" MODEMS. ═OST INEXPENSIVE MODEMS ARE '300 BAUD' WHICH IS A TRANSFER
" RATE OF ROUGHLY 30 CHARACTERS PER SECOND.
"
" 4. ╨RINT A FILE/BUFFER TO SCREEN/PRINTER - ╘HIS ALLOWS YOU TO DISPLAY
" ON THE SCREEN OR PRINT ON THE PRINTER, THE TEXT CAPTURED IN THE
" COMPUTERS MEMORY WITH THIS PROGRAM, OR A FILE ON THE DISK.
"
" 5. ┼XAMINE/ALTER FUNCTION KEYS - ╘HE ├OMMODORE 64 HAS 4 FUNCTION KEYS.
" ╘HIS PACKAGE ALLOWS YOU TO MAKE THEM SEND TO ANOTHER COMPUTER, ONE OR
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...6
" MORE CHARACTER(S) BY JUST ONE SINGLE KEYPRESS. ╞OR EXAMPLE, MOST DATA
" BASES HAVE A '╚┼╠╨' COMMAND. ┘OU MIGHT WANT TO HAVE ONE KEY PRESS SEND
" '╚┼╠╨' AND A <╥┼╘╒╥╬> TO THE REMOTE COMPUTER. ╧R, SIMILARLY, ANY
" FREQUENTLY USED COMMAND/STRING OF TEXT CAN BE ASSIGNED TO A SINGLE
" KEYPRESS.
"
" 6. ╠OAD OR SAVE PARAMETERS - ╘HE PROTOCOLS, THE FUNCTION KEY
" DEFINITIONS, AND EVEN THE SCREEN, TEXT, AND BORDER COLOURS, MAY BE
" LOADED OR SAVED AS A 'PARAMETER FILE' ON DISK. ╘HIS IS USEFUL FOR
" COMMUNICATING WITH DIFFERENT SYSTEMS, WITH DIFFERING PROTOCOLS, AND
" COMMONLY USED COMMANDS WHICH YOU HAVE DEFINED IN THE FUNCTION KEYS. ┴N
" EXAMPLE OF TWO PARAMETER FILES MIGHT BE '╙OURCE' AND '├OMPUSERVE.'
"
" 7. ╙END FILE TO MODEM - ╘HIS IS A SIMPLE FILE TRANSFER OPTION. ┴ FILE
" ON THE DISKETTE IN THE DRIVE CAN BE TRANSMITTED TO THE REMOTE COMPUTER.
" ╘HIS FOR EXAMPLE, COULD BE USED TO SEND ELECTRONIC MAIL PREPARED ON
" YOUR COMPUTER WHEN YOU WEREN'T COMMUNICATING WITH THE REMOTE COMPUTER.
"
" 8. ╙AVE MEMORY BUFFER - ╘HIS OPTION ALLOWS YOU TO SAVE THE TEXT STORED
" IN THE COMPUTERS MEMORY IN A FILE ON THE DISK DRIVE.
"
" 9. ┼XIT PROGRAM - ╘HIS OPTION WILL RESET THE COMPUTER, AS IF IT WERE
" TURNED OFF AND ON AGAIN.
"
" ╘ECHNICAL NOTE:
"
" ╘HIS PROGRAM IS DESIGNED FOR COMMUNICATING VIA THE ╥╙-232 PORT OF THE
" ├OMMODORE-64 (AN EDGE CONNECTOR, WHICH WILL REQUIRE SUITABLE CABLE, OR
" A ╓╔├1011┴ ADAPTOR) TO ANOTHER COMPUTER, OR MODEM, AT SPEEDS FROM 50 TO
" 2400 BAUD. ╙INCE THE ├OMMODORE-64 HAS ONLY ONE ╥╙-232 PORT, THE
" PROGRAM ASSUMES THE PRINTER IS CONNECTED TO THE ├┬═ SERIAL PORT AS
" DEVICE 4, OR SOME OTHER INTERFACE CARTRIDGE WHICH INTERCEPTS THE ╦┼╥╬┴╠
" FUNCTIONS (FOR EXAMPLE, ╥╘├'S 64-╠╔╬╦ CARTRIDGE, WHICH ALLOWS ANY ╔┼┼┼
" PRINTERS TO BE CONNECTED TO THE ├OMMODORE-64. ╘HIS PROGRAM WILL WORK
" WITH THAT CARTRIDGE INSTALLED.)
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...7
" ╘ERMINAL MODE (OPTION 1 FROM THE MENU)
"
" ╨RESSING '1' FROM THE MENU PUTS YOU IN 'TERMINAL MODE' WHICH IS THE
" ENVIRONMENT WHERE ┴╠╠ COMMUNICATING WITH ANOTHER, REMOTE COMPUTER IS
" DONE.
"
" ┴ STATUS LINE IS SHOWN ON THE TOP LINE OF THE SCREEN. ╔T SHOULD LOOK
" LIKE:
"
" :╘:╙:╧:╫:─:┬:-12:00:00-42000:0:000:000:
" ! ! ! ! ! ! ! ! ! ! !--├HARACTER CODE
" ╙TATUS ╔NDICATORS ! ! ! ! RECEIVED
" ! ! ! !
" ├LOCK------------! ! ! !------├HARACTER CODE SENT
" ! !
" ╞REE MEMORY IN BUFFER----! !----------╬O. NULLS TO BE SENT
" AFTER A CARRIAGE RETURN
"
"
" ╘ - (╘HE 'TIMEOUT' INDICATOR) ╫HEN YOU TRANSMIT CHARACTERS TO A REMOTE
" COMPUTER, USUALLY BY TYPING, THE USUAL ENVIRONMENT OF COMMUNICATIONS IS
" KNOWN AS 'FULL DUPLEX' WHICH SIMPLY MEANS THAT THE [LARGER] REMOTE
" COMPUTER WILL SEND BACK TO THE ├OMMODORE-64 EACH CHARACTER YOU SEND TO
" IT. ╘HIS INDICATOR WILL 'LIGHT UP' (GO INTO INVERSE VIDEO) IF, WHEN IN
" FULL DUPLEX, A CHARACTER YOU TRANSMIT IS NOT SENT BACK BY THE REMOTE
" COMPUTER WITHIN A SHORT TIME.
"
" ╙ - (╘HE ┴╠╠├┴╨╙ MODE INDICATOR) ╘HE SHIFTLOCK KEY ON THE
" ├OMMODORE-64'S KEYBOARD IS NOT ALWAYS USEFUL FOR ENTERING UPPER CASE
" TEXT, BECAUSE IT WILL SHIFT THE NUMERICS AND ALL OTHER KEYS ALSO, SO AN
" '┴╠╠├┴╨╙' MODE IS PROVIDED FOR SIMPLY ENSURING ALL ALPHA CHARACTERS
" ('A' TO 'Z') TRANSMITTED ARE SENT IN ╒╨╨┼╥ CASE REGARDLESS OF WHETHER
" THE SHIFT KEY IS DEPRESSED. ╘HIS MODE CAN BE TURNED ON AND OFF BY
" HOLDING DOWN THE ├OMMODORE KEY AND PRESSING 'S'.
"
" ╧ - (╘HE ╧╒╘╨╒╘-╙╒╨╨╥┼╙╙┼─ MODE INDICATOR) ╫HEN LIT, THE USER'S OUTPUT
" WILL NOT BE DISPLAYED (IN EITHER HALF OR FULL DUPLEX). ╘HIS IS USEFUL
" FOR NOT ALLOWING OTHER PEOPLE TO SEE YOU ENTERING PASSWORDS ON REMOTE
" COMPUTER SYSTEMS, FOR EXAMPLE. ╘HE INDICATOR CAN BE TURNED ON AND OFF
" BY HOLDING DOWN THE ├OMMODORE KEY AND PRESSING 'S'.
"
" ╫ - (╘HE ╫╧╥─-╫╥┴╨ MODE INDICATOR) ╙INCE THE ├OMMODORE-64 CAN DISPLAY
" 40 CHARACTERS ON A LINE, INSTEAD OF 80 (OR EVEN 132) COLUMNS AS MOST
" COMMERCIALLY USED TERMINALS CAN, WORDS MAY GET 'SPLIT' AT THE RIGHT
" HAND SIDE OF YOUR SCREEN (FOR EXAMPLE, THE WORD '├OMMODORE' BEGINNING
" IN THE 35TH COLUMN, AND '├OMMO' IS ON THAT LINE, AND 'DORE' ENDS UP AT
" THE START OF THE NEXT LINE). ╫HEN THE ╫╧╥─-╫╥┴╨ INDICATOR IS LIT, THE
" PROGRAM WILL AUTOMATICALLY ENSURE THAT NO WORDS ARE SPLIT AT THE END OF
" A LINE. ╔T DOES THIS BY PUSHING THE WORD ONTO THE NEXT LINE IF IT
" WON'T FIT ON THE CURRENT LINE. ╫ORD-WRAP MODE CAN BE TURNED ON AND OFF
" BY HOLDING DOWN THE ├OMMODORE KEY AND PRESSING 'W'.
"
" ─ - (╘HE ─╔╙╨╠┴┘-├╧╬╘╥╧╠-├╚┴╥┴├╘┼╥╙ MODE INDICATOR) ╔T IS MOST OFTEN
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...8
" NOT NECESSARY TO SEE THE INCOMING CONTROL CHARACTERS (CHARACTER CODES 0
" THROUGH 31 DECIMAL, EXCLUDING CERTAIN ONES, FOR EXAMPLE, '├ARRIAGE
" ╥ETURN', WHICH IS 13), BUT IN CASE THE USER DOES WISH TO SEE THEM, THE
" PROGRAM ALLOWS FOR THIS. ├ONTROL CHARACTERS WILL BE SHOWN AS
" HIGHLIGHTED CHARACTERS ON THE SCREEN, FROM '@' TO '┌'. ╘O
" ENABLE/DISABLE THIS MODE, HOLD DOWN THE ├OMMODORE KEY AND PRESS 'D'.
"
" ┬ - (╘HE ┬╒╞╞┼╥-╧╨┼╬/├╠╧╙┼─ MODE INDICATOR) ┴NY TEXT WHICH IS DISPLAYED
" CAN BE STORED IN THE MEMORY OF THE ├OMMODORE-64, FOR LATER VIEWING, OR
" HARDCOPY ON THE PRINTER, OR EVEN STORING TO THE DISK IN A FILE. ╘HIS
" ABILITY IS KNOWN AS A 'MEMORY BUFFER' BECAUSE THE TEXT IS 'BUFFERED'
" FOR LATER USAGE. ╘HE FIVE DIGIT NUMBER ON THE STATUS LINE INDICATES
" HOW MUCH MEMORY IS LEFT FOR TEXT TO BE STORED. ╘HE TEXT IS ONLY PUT
" INTO THE MEMORY BUFFER IF THE INDICATOR IS LIT, WHICH ALLOWS YOU TO
" SELECTIVELY STORE INFORMATION (FOR EXAMPLE, NEWS STORIES OR ONLY
" CERTAIN STOCK INFORMATION). ╘O START OR STOP THE PROGRAM STORING
" INCOMING TEXT IN THE MEMORY BUFFER, HOLD DOWN THE ├OMMODORE KEY, AND
" PRESS 'B'. ╔F YOU WISH TO 'CLEAR OUT' THE MEMORY BUFFER, I.E.,
" INSTRUCT THE COMPUTER TO 'FORGET' ALL IT HAS STORED FOR YOU, THUS
" MAKINNG AVAILABLE ALL THE MEMORY AGAIN, HOLD DOWN EITHER SHIFT KEY, AND
" PRESS '*'.
"
" ╞OR QUICK TEMPORARY STORAGE OF, FOR EXAMPLE, AN ADDRESS, OR OTHER PIECE
" OF INFORMATION YOU QUICKLY WANT TO CAPTURE, BUT YOU DIDN'T HAVE YOUR
" MEMORY BUFFER OPEN, HOLD DOWN THE ├OMMODORE KEY, AND PRESS 'X'. ╘HIS
" SWAPS THE SCREENS CONTENTS WITH A ╙┼├╧╬─ SCREEN. ╨RESSING '├OMMODORE
" ╪' AGAIN, WILL BRING BACK THE 'FIRST' SCREEN AGAIN.
"
" ╘HE CLOCK - FUNCTIONS LIKE A NORMAL CLOCK; CAN BE USED TO INFORM YOU OF
" CONNECT TIME ON A SYSTEM, OR GIVE YOU THE ACTUAL TIME. ├AN BE RESET TO
" 00:00:00 BY HOLDING DOWN THE ├OMMODORE KEY AND PRESSING 'T', OR SET TO
" A GIVEN TIME FROM THE ┼XAMINE/ALTER PROTOCOLS OPTION (3) FROM THE MENU.
"
" ╙UMMARY OF KEYBOARD 'FUNCTIONS' IN TERMINAL MODE:
" <╙╚╔╞╘ *> - ├LEAR MEMORY BUFFER
" <├OMMODORE ╙> - ┼NABLE/DISABLE ┴╠╠ ├┴╨╔╘┴╠╙ MODE
" <├OMMODORE ╧> - ┼NABLE/DISABLE DISPLAYING OF YOUR TYPING FOR PRIVACY
" <├OMMODORE ╫> - ┼NABLE/DISABLE AUTOMATIC FORMATTING OF THE END OF EACH
" LINE
" <├OMMODORE ─> - ┼NABLE/DISABLE DISPLAY OF CONTROL CHARACTERS (┴╙├╔╔
" 0-26)
" <├OMMODORE ┬> - ┼NABLE/DISABLE MEMORY CAPTURE OF DISPLAYED TEXT
" <├OMMODORE ╨> - ╥ESET BUFFER POINTER WITHOUT CLEARING BUFFER
" <├OMMODORE ├> - ├LOSE DISK FILE WHEN SENDING A FILE FROM DISK
" <├OMMODORE +> - ├HANGE BACKGROUND COLOUR OF THE SCREEN
" <├OMMODORE -> - ├HANGE COLOUR OF TEXT
" <├OMMODORE *> - ├HANGE BORDER COLOUR
" <LEFT ARROW> IS DISPLAYED AS AN UNDERSCORE ON THE SCREEN (CONSISTENT
" WITH 'MOST' TERMINALS).
" <├╘╥╠ ╠> ╔F RECEIVED, ACTS AS A 'FORM FEED' AND CLEARS THE SCREEN
" <├╘╥╠ :> ╟ENERATES AN ┼╙├ (┴╙├╔╔ 27) CHARACTER
" <├OMMODORE ╪> ╙WAP SCREEN WITH SECOND STORED, SCREEN.
" <├╘╥╠ +> ╔NCREASE THE NUMBER OF NULLS TO BE SENT AFTER A
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...9
" CARRIAGE RETURN (MAXIMUM 9)
" <├╘╥╠ -> ─ECREASE THE NUMBER OF NULLS TO BE SENT AFTER A
" CARRIAGE RETURN (MINIMUM 0)
" <SHIFTED ─┼╠> - ╟ENERATES ┴╙├╔╔ ─┼╠┼╘┼ CHARACTER (VALUE 127)
" <├OMMODORE ╘> - ╥ESETS CLOCK TO 0:00:00
"
" ╘HE FUNCTION KEYS SEND STRINGS AS DESIGNATED:
"
" ╒NSHIFTED..............<╞01>/<╞03>/<╞05>/<╞07>
" ╙HIFTED................<╞02>/<╞04>/<╞06>/<╞08>
" ├OMMODORE..............<╞09>/<╞10>/<╞11>/<╞12>
" ├╘╥╠...................<╞13>/<╞14>/<╞15>/<╞16>
"
" ╠OCAL EDITING MODE
"
" ╘HIS TERMINAL PROGRAM GIVES YOU TO DO FULL SCREEN EDITING (AS YOU DO
" WHEN CORRECTING MISTAKES, WHEN ENTERING A PROGRAM), EVEN WHEN THE
" COMPUTER YOU ARE COMMUNICATING WITH, DOES NOT SUPPORT SUCH A FUNCTION.
"
" ╔F ╥┼╘╒╥╬ IS PRESSED WHILE EITHER SHIFT KEY IS HELD DOWN IS ENTERED
" WHEN IN TERMINAL MODE, THE CURSOR WILL FLASH (INSTEAD OF BEING
" 'SOLID'). ╔NCOMING TEXT WILL STILL BE OUTPUT TO THE SCREEN AS NORMAL,
" BUT FURTHER TYPING BY THE USER IS ╬╧╘ TRANSMITTED TO THE REMOTE
" COMPUTER. ┴T THIS POINT, YOU CAN USE THE ├╒╥╙╧╥ ═╧╓┼═┼╬╘ ╦┼┘╙ (UP,
" DOWN, LEFT AND RIGHT), THE ╔╬╙ERT KEY, THE ─┼╠ETE KEY, THE ╚╧═┼ AND ├╠╥
" KEYS, AND IN FACT, ┼╓┼╥┘ KEY TO EDIT AND ENTER TEXT ONTO THE SCREEN.
" ╫HEN YOU WANT TO SEND A LINE OF TEXT, YOU SIMPLY POSITION THE CURSOR ON
" THE FIRST CHARACTER TO BE SENT, AND ENTER ANOTHER <╙╚╔╞╘┼─ ╥┼╘╒╥╬>.
" ╘HE PROGRAM WILL THEN ENTER ALL CHARACTERS FROM THAT POINT ON ON THE
" SCREEN LINE, AND ALSO TRANSMIT A ╥┼╘╒╥╬.
"
" '╫HAT CAN ╔ USE THAT FOR?' YOU SAY. ╠ET'S TAKE A LOOK AT AN EXAMPLE
" USAGE OF THIS FEATURE:
"
" ╠ET US SUPPOSE THE COMPUTER YOU ARE COMMUNICATING WITH IS AWAITING YOUR
" COMMAND. ┘OU WANT TO SEND A LETTER TO ANOTHER USER, AND YOU ENTER THE
" COMMAND:
"
" ═┴╔╠ ╙┼╬─ ╩╧╚╬ ┼╪╨╥┼╙╙
"
" ╘HE SYSTEM RESPONDS WITH:
"
" ╒SER '╩╧╚╬' NOT FOUND.
" ╥E-ENTER:
"
" ┴ND YOU REALISE THAT YOU ENTERED THE ╬┴═┼ OF THE USER YOU WISHED TO
" SEND MAIL TO INSTEAD OF THEIR COMPUTER ACCOUNT '╔─', WHICH THIS
" PARTICULAR SYSTEM REQUIRES. ┘OU NO LONGER HAVE TO TYPE THIS COMMAND IN
" ALL OVER AGAIN, YOU SIMPLY ENTER 'LOCAL EDITING MODE' BY HOLDING DOWN
" THE SHIFT AND PRESSING ╥┼╘╒╥╬. ╘HE CURSOR SHOULD BE FLASHING. ┘OU
" MOVE THE CURSOR UP USING THE CURSOR MOVEMENT KEYS AND CORRECT THE
" MISTAKE:
"
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...10
" ═┴╔╠ ╙┼╬─ ╪┘┌999 ┼╪╨╥┼╙╙
"
" ╘O SEND THE WHOLE LINE AGAIN, YOU SIMPLY POSITION THE CURSOR ON THE '═'
" IN '═┴╔╠' (OFTEN EASIEST BY PRESSING RETURN, AND THEN CURSOR UP, IF
" YOU'RE ON THE SAME LINE AS THE LINE YOU WISH TO SEND), AND THEN PRESS
" RETURN WHILE HOLDING DOWN THE SHIFT AGAIN, AND YOU'LL SEE THE LINE
" RE-ENTERED FOR YOU.
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...11
" ─ISK DIRECTORY (OPTION 2 FROM THE MENU)
"
" ┴S SOON AS YOU PRESS '2' FROM THE MENU, THE SCREEN WILL CLEAR, AND THE
" DIRECTORY WILL BE LISTED ONTO THE SCREEN. ┴S IT IS LISTED, ANY KEY CAN
" BE PRESSED TO STOP AND RESUME THE LISTING, AND IF THE ╙╘╧╨ KEY IS
" PRESSED AT ANY TIME, THE LISTING WILL TERMINATE.
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...12
" ┼XAMINE/ALTER PROTOCOLS (OPTION 3 FROM THE MENU)
"
" ╫HEN THE PROGRAM IS RUN, THE ╥╙232 AND TERMINAL PARAMETERS ARE SET TO
" DEFAULTS WHICH ARE SUITABLE FOR PRACTICALLY ALL TERMINAL WORK AT 300
" BAUD, WHICH INCLUDES THE ╓╔├═╧─┼═.
"
" ╫HEN 3 IS PRESSED FROM THE MENU, THE CURRENT PROTOCOLS ARE DISPLAYED.
" ╘O ALTER THEM, SIMPLY PRESS THE NUMERIC KEY ALONGISDE THE PARTICULAR
" PROTOCOL. ╞OR EXAMPLE, TO CHANGE DUPLEX, PRESS '1'. ╫HEN YOU'VE SET
" THEM TO YOUR PARTICULAR REQUIREMENTS, PRESSING THE ╙╘╧╨ KEY WILL RETURN
" YOU TO THE MENU.
"
" ╘HE PROTOCOLS ARE:
"
" '1' - ─UPLEX - ALTERNATIVES - ╚ALF, OR ╞ULL. ╔N HALF DUPLEX, EACH
" CHARACTER TRANSMITTED BY YOUR COMPUTER IS DISPLAYED BY THE PROGRAM ON
" THE SCREEN. ╔N FULL DUPLEX, THE PROGRAM EXPECTS THE REMOTE COMPUTER TO
" SEND EACH CHARACTER BACK WHICH YOUR COMPUTER SENDS TO IT. ┴LMOST ALL
" COMMERCIAL NETWORKS OPERATE IN FULL DUPLEX. ╔F, FOR EXAMPLE, YOU WANT
" TO COMMUNICATE WITH ANOTHER ├OMMODORE-64 THOUGH, BOTH YOU, AND YOUR
" REMOTE TELECOMPUTING PARTNER WOULD NEED TO OPERATE IN HALF DUPLEX.
"
" '2' - ╠INE FEED - ALTERNATIVES - ┘ES, OR ╬O. ┴FTER YOU TRANSMIT A
" CARRIAGE RETURN, SOME NETWORKS REQUIRE A LINEFEED ALSO. ╘HIS OPTION
" ALLOWS YOU THE ALTERNATIVE OF HAVING A LINE FEED SENT AUTOMATICALLY
" AFTER A RETURN, OR NOT. ╘HIS IS BECOMING LESS LIKELY THOUGH, AND IN
" MOST OPERATION, YOU WOULD HAVE THE OPTION SET TO '╬O'.
"
" '3' - ╙TOP BITS - ALTERNATIVES - 1, OR 2. ╘HE ╥╙232 INTERFACE
" SEPARATES EACH CHARACTER OF INFORMATION WITH 1 OR 2 STOP 'PAUSES' OR
" BITS. ╙OMETIMES, MORE OFTEN WITH 1200 BAUD, YOU MIGHT NEED TO SEND 2,
" INSTEAD OF THE FAR MORE USUAL 1.
"
" '4' - ╨ARITY - ALTERNATIVES - ╬ONE, ┼VEN, ╧DD, ╙PACE, OR ═ARK. ╘HE
" ╥╙232 INTERFACE CAN MARK THE END OF EACH CHARACTER, WITH AN EXTRA PIECE
" OF INFORMATION (KNOWN AS A 'PARITY BIT'), WHICH GIVES EITHER COMPUTER,
" A SLIGHTLY MORE SECURE WAY OF ENSURING GOOD DATA TRANSMISSION. ┘OU
" WOULD HAVE TO INVESTIGATE WHICH PARITY THE COMPUTER YOU ARE
" COMMUNICATING WITH REQUIRES. ═OST SYSTEMS DON'T REQUIRE ANY PARITY, OR
" JUST IGNORE IT.
"
" '5' - ┬AUD RATE - ALTERNATIVES - 110, 150, 300, 600, 1200, 1800, OR
" 2400. ╘HE ╥╙232 INTERFACE CAN TRANSMIT INFORMATION AT DIFFERENT
" SPEEDS. ╘HIS WILL NEED TO BE SET ACCORDING TO YOUR MODEM, AND/OR THE
" COMPUTER YOU ARE COMMUNICATING WITH. 300 BAUD IS THE MOST COMMON, WITH
" 1200 BEING USED FOR 'HIGH SPEED' COMMUNICATION USUALLY.
"
" '6' - ╫ORD LENGTH - ALTERNATIVES - 5, 6, 7, OR 8 BITS. ╙OME REMOTE
" COMPUTERS IGNORE, OR DON'T USE ALL OF THE 8 BITS IN A BYTE. ╔F, FOR
" EXAMPLE, YOU SET THIS PARAMETER TO 7 BITS, THE 8TH BIT WILL BE IGNORED.
"
" '7' - ╙ET TIME - ASKS FOR THE TIME YOU WISH TO SET THE CLOCK TO (WHICH
" IS DISPLAYED IN TERMINAL MODE). ╘HE FORMAT OF THE TIME YOU ENTER IS
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...13
" CHECKED AND IF THE PROGRAM DOESN'T UNDERSTAND WHAT YOU HAVE ENTERED,
" THE BELL WILL RING, AND THE TIME WILL NOT BE ALTERED. ─O ╬╧╘ ENTER IN
" 24 HOUR FORMAT, IT'S A 12 HOUR CLOCK. ┘OU CAN ENTER JUST THE HOURS AND
" MINUTES (THE SECONDS WILL DEFAULT TO 0), OR YOU CAN ENTER THE FULL
" HOURS, MINUTES AND SECONDS. 2 DIGITS FOR EACH PART MUST BE ENTERED,
" THEREFORE, IF THE TIME IS FIVE MINUTES AFTER TWO, YOU SHOULD ENTER:
"
" 0205
"
" OR
"
" 020500
"
" '9' - ╥ETURN TO MENU - IF PRESSED, THE PROGRAM RETURNS TO THE MENU.
" ╘HIS CAN ALSO BE ACHIEVED AT ANY TIME BY PRESSING THE ╙╘╧╨ KEY.
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...14
" ╨RINT FILE/BUFFER TO SCREEN/PRINTER (OPTION 4 FROM THE MENU)
"
" ╘HIS IMPORTANT OPTION, ALLOWS YOU TO PRINT, TO EITHER THE SCREEN OR
" YOUR PRINTER, THE TEXT YOU CAPTURED IN THE COMPUTER'S MEMORY BUFFER, OR
" A DISK FILE.
"
" ╫HEN '4' IS PRESSED TO SELECT THIS OPTION, YOU WILL BE ASKED:
"
" ┬UFFER OR FILE?
" (╨RESS '┬' OR '╞')
"
" ┴S IMPLIED, PRESS 'B' IF YOU WISH TO PRINT WHATEVER TEXT YOU MAY HAVE
" STORED IN YOUR MEMORY BUFFER, OR 'F' FOR A DISK FILE.
"
" ╚AVING SELECTED 'B' OR 'F', YOU WILL THEN BE ASKED (THE SCREEN WILL
" CLEAR) IF YOU WISH TO PRINT TO THE SCREEN OR PRINTER IN A SIMILAR 'ONE
" KEY' SELECTION. ╨RESS 'S' IF YOU JUST WISH TO VIEW THE MEMORY BUFFER
" OR DISK FILE ON THE SCREEN, OR 'P' IF YOU WANT TO PRINT THE TEXT ON
" YOUR PRINTER.
"
" ╔F YOU ARE PRINTING A DISK FILE (INSTEAD OF THE MEMORY BUFFER), YOU
" WILL BE ASKED FOR THE NAME OF THE FILE. ╔F YOU ENTER A FILENAME AND
" THE FILE IS NOT ON THE DISKETTE IN THE DRIVE, A BELL WILL SOUND, AND
" YOU WILL BE RETURNED TO THE MAIN MENU.
"
" ╔F YOU OPT TO OUTPUT EITHER THE CONTENTS OF YOUR MEMORY BUFFER, OR THE
" DISK FILE TO YOUR PRINTER, YOU WILL THEN BE ASKED TO SELECT YOUR TYPE
" OF PRINTER. ╬OTE, THE PROGRAM ASSUMES THE PRINTER IS CONNECTED TO THE
" ├┬═ SERIAL PORT AS DEVICE 4, OR SOME OTHER INTERFACE CARTRIDGE WHICH
" INTERCEPTS THE ╦┼╥╬┴╠ FUNCTIONS (FOR EXAMPLE, ╥╘├'S 64-╠╔╬╦ CARTRIDGE,
" WHICH ALLOWS ANY ╔┼┼┼ PRINTERS TO BE CONNECTED TO THE ├OMMODORE-64.
" ╘HIS PROGRAM WILL WORK WITH THAT CARTRIDGE INSTALLED.)
"
" ╘HE PROGRAM'S OPTIONS INCLUDE:
"
" 1)1525 (OR 1526), 2)╧THER ├┬═ PRINTER (╔┼┼┼ PRINTERS, ╬╧╘ 8300╨), OR
" 3)╘RUE ┴╙├╔╔ PRINTER (OTHER BRAND OF PRINTER OR ├OMMODORE 8300╨).
"
" ╫HILE THE FILE/BUFFER IS PRINTING TO SCREEN/PRINTER, ANY KEY CAN BE
" PRESSED TO STOP AND RESUME PRINTING, AND IF THE ╙╘╧╨ KEY IS PRESSED AT
" ANY TIME, PRINTING WILL TERMINATE, AND THE PROGRAM WILL PROMPT YOU TO
" PRESS ANY KEY TO RETURN TO THE MENU.
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...15
" ┼XAMINE/ALTER FUNCTION KEYS (OPTION 5 FROM THE MENU)
"
" ╘HIS OPTION ALLOWS YOU TO EXAMINE OR CHANGE, THE STRINGS OF CHARACTERS
" WHICH WILL BE SENT BY THE FUNCTION KEYS, AND FUNCTION KEYS IN
" CONJUNCTION WITH SHIFT/├OMMODORE/├╘╥╠ KEYS.
"
" ╞OR YOUR OWN SECURITY, A PASSWORD IS REQUESTED WHEN THIS OPTION IS
" SELECTED FROM THE MENU. ╫HEN NO PARAMETER FILE HAS BEEN LOADED, AND
" THE PASSWORD HAS NOT BEEN CHANGED, IT IS DEFAULTED TO '64'.
"
" ╚AVING ENTERED THE PASSWORD, YOU WILL SEE A DISPLAY LIKE:
"
" ----------------------------------------
" 5. ┼XAMINE/ALTER FUNCTION KEYS
" F01='
" F02='
" F03='
" F04='
" F05='
" F06='
" F07='
" F08='
" F09='
" F10='
" F11='
" F12='
" F13='
" F14='
" F15='
" F16='
" ┼NTER KEY TO CHANGE, PRESS '╙╘╧╨'
" FOR MENU, OR 'P' TO CHANGE PASSWORD.
" ----------------------------------------
"
" ╘O ALTER A STRING, ENTER THE FUNCTION KEYPRESS ITSELF, FOR EXAMPLE,
" FUNCTION KEY STRING 11 (F11) IS ENTERED BY HOLDING DOWN THE ├OMMODORE
" KEY, AND PRESSING 'F5'. (╞OR A FULL LIST OF THE KEY SEQUENCES, SEE
" '╙UMMARY OF KEYBOARD FUNCTIONS' IN SECTION 2.) ╚AVING SELECTED THE
" STRING TO CHANGE, YOU WILL BE PROMPTED TO ENTER THE TEXT STRING TO BE
" ASSIGNED TO THAT KEY. ┼NTER THIS, FOR EXAMPLE:
"
" ┼NTER NEW TEXT FOR FUNCTION KEY F11
" >
"
" ┘OU TYPE 'HELLO', AND PRESS ╥┼╘╒╥╬.
"
" ╘HE PROGRAM THEN ASKS IF YOU WANT A ╥┼╘╒╥╬ TO BE TRANSMITTED AFTER THE
" STRING WHEN YOU PRESS THE FUNCTION KEY, BY PROMPTING YOU WITH:
"
" ┴DD A CARRIAGE RETURN?
"
" ┼NTER 'Y', OR 'N' (YES, OR NO) AS DESIRED. ╞OR FREQUENTLY EXECUTED
" COMMANDS, FOR EXAMPLE, YOU WILL WANT TO ADD A CARRIAGE RETURN. ╙INCE
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...16
" YOUR FUNCTION KEY ASSIGNMENTS ARE COMPLETELY SECURE, YOU CAN EVEN
" ASSIGN YOUR LOG-IN PASSWORD TO REMOTE SYSTEMS.
"
" ┘OU ARE THEN ASKED IF YOU WANT THE STRING TO BE DISPLAYED ON THE SCREEN
" OR NOT, WITH THE PROMPT:
"
" ┼CHO STRING TO SCREEN? (┘/╬)
"
" ┼NTER 'Y', OR 'N' (YES, OR NO) AS DESIRED. ╔F YOU DO NOT WISH
" 'VIEWERS' WATCHING WHAT COMMANDS OF TEXT YOU ARE SENDING TO THE
" COMPUTER, SUCH AS LOG-IN PASSWORDS, YOU WOULD WANT TO PRESS 'N' FOR
" THIS OPTION.
"
" ╘HE STRING IS THEN DISPLAYED IN ITS PLACE IN THE DEFINITIONS, AND IF
" YOU CHOSE FOR THE STRING NOT TO BE ECHOED TO THE SCREEN, THERE ARE
" SMALL 'BLOCKS' AROUND THE ASSIGNMENT.
"
" ╔F YOU PRESS 'P' FROM THE PROMPT, YOU WILL BE ASKED FOR A NEW PASSWORD
" (THE ONE YOU ENTER WHEN SELECTING THIS OPTION FROM THE MENU). ╘HIS
" PASSWORD IS THE ╧╬╠┘ WAY YOU CAN GET INTO THE SECTION, SO IF YOU CHANGE
" IT, BE SURE NOT TO FORGET IT!
"
" ╫HEN YOU'RE FINISHED, PRESS ╙╘╧╨ TO RETURN TO THE MENU.
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...17
" ╠OAD OR SAVE PARAMETERS (OPTION 6 FROM THE MENU)
"
" ╘HE 'PARAMETERS' INCLUDE THE PROTOCOLS, THE FUNCTION KEY DEFINITIONS,
" AND THE SCREEN, TEXT, AND BORDER COLOURS. ┘OU MAY BE SAVE THE DETAILS
" OF THE WAY YOU 'CONFIGURE' THE PROGRAM FOR COMMUNICATING WITH A
" PARTICULAR REMOTE COMPUTER AS A FILE ON THE DISK, IN A PARAMETER FILE.
"
" ┴N EXAMPLE OF TWO PARAMETER FILES MIGHT BE 'SOURCE' AND 'COMPUSERVE'
" FOR COMMUNICATING WITH THESE LARGE, POPULAR DATABASE NETWORKS.
"
" ╫HEN '6' IS PRESSED TO SELECT THIS OPTION, YOU WILL BE ASKED:
"
" ╠OAD OR ╙AVE PARAMETERS?
" (╨RESS '╠' OR '╙')
"
" ┴S IMPLIED, PRESS 'L' IF YOU WISH TO LOAD IN A PARAMETER FILE YOU HAVE
" PREVIOUSLY STORED, OR 'S' IF YOU WISH TO SAVE THE CURRENT PARAMETERS IN
" A DISK FILE.
"
" ╚AVING SELECTED 'L' OR 'S', YOU WILL BE ASKED FOR THE NAME OF THE FILE.
" ╔F YOU ENTER A FILENAME WHICH CAUSES A DISK ERROR, A BELL WILL SOUND,
" AND YOU WILL BE RETURNED TO THE MAIN MENU.
"
" ╠OAD PARAMETERS: ╘HE COLOURS WILL BE SET, THE ╥╙232 WILL BE SETUP, THE
" FUNCTION KEYS WILL BE RE-ASSIGNED.
"
" ╙AVE PARAMETERS: ╘HE COLOURS WILL BE SAVED, THE ╥╙232 PARAMETERS WILL
" BE SAVED, AND THE FUNCTION KEYS ASSIGNMENTS WILL BE SAVED.
"
" ┴FTER EITHER FUNCTION, THE PROGRAM WILL, ONCE AGAIN, RETURN TO THE
" MENU.
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...18
" ╙END A FILE TO THE MODEM (OPTION 7 FROM THE MENU)
"
" ┘OU WILL BE ASKED FOR THE NAME OF THE FILE ON DISK TO BE TRANSMITTED.
" ╔F YOU ENTER A FILENAME AND THE FILE IS NOT ON THE DISKETTE IN THE
" DRIVE, A BELL WILL SOUND, AND YOU WILL BE RETURNED TO THE MAIN MENU.
" ╔F THE FILE IS PRESENT, THE PROGRAM WILL GO INTO TERMINAL MODE, AND
" EACH CHARACTER FROM THE FILE WILL BE TRANSMITTED TO THE COMPUTER AS IF
" YOU WERE TYPING IT. ╔F '├OMMODORE C' IS ENTERED WHILE THE FILE IS
" STILL BEING TRANSMITTED, OR A DISK ERROR OCCURS, OR THE END OF THE FILE
" IS REACHED, THE PROCESS WILL STOP, THE DISK FILE WILL BE CLOSED, AND
" THE USER WILL REMAIN IN TERMINAL MODE.
"
" ╘ECHNICAL NOTE:
" ╙OMETIMES, THE NUMBER OF NULLS TO BE SENT AFTER A CARRIAGE RETURN WILL
" NEED TO BE SET TO MORE THAN ZERO TO ENSURE THE COMPUTER YOU ARE
" COMMUNICATING WITH DOES NOT DROP ANY CHARACTERS AFTER A CARRIAGE
" RETURN.
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...19
" ╙AVE MEMORY BUFFER (OPTION 8 FROM THE MENU)
"
" ╘EXT CAPTURED IN THE MEMORY BUFFER IN TERMINAL MODE, CAN BE STORED ON
" DISK, IN A FILE, FOR LATER VIEWING/PRINTING, OR EVEN USAGE WITH OTHER
" SOFTWARE.
"
" ┘OU WILL BE ASKED FOR THE NAME OF THE FILE UNDER WHICH YOU WISH TO
" STORE THE MEMORY BUFFER CONTENTS. ╔F YOU ENTER A FILENAME WHICH CAUSES
" AN ERROR, A BELL WILL SOUND, AND YOU WILL BE RETURNED TO THE MAIN MENU.
" ╧THERWISE, THE STORING WILL PROCEED, WHEN COMPLETED, THE PROGRAM WILL
" RETURN TO THE MENU.
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM
" ╨RELIMINARY ╘┼╥═-64 MANUAL ╨AGE...20
" ┼XIT PROGRAM (OPTION 9 FROM THE MENU)
"
" ╨RESSING '9' FROM THE MENU WILL RESET YOUR COMPUTER, AS IF IT HAD BEEN
" TURNED OFF AND ON AGAIN.
" 8/2/83 ┬Y ╨AUL ╚IGGINBOTTOM